The Universal Print Structure(IM:XP)

The Universal Print Structure
The universal print structure, of data type gxUniversalPrintRecord, contains information about the current print job. You need to know about the format of this structure if you are converting information from a print record used with the Macintosh Printing Manager. This structure is used instead of the Macintosh Printing Manager TPrint structure. It is used with the GXConvertPrintRecordFrom, GXConvertPrintRecordTo, and GXPrintRecordToJob messages, which are described in the section "Compatibility Messages" beginning on page 4-147. The print record used with the Macintosh Printing Manager is described in Inside Macintosh: Imaging With QuickDraw.
struct gxUniversalPrintRecord {
   short    prVersion;
   short    appDev;
   short    appVRes;
   short    appHRes;
   Rect     appPage;
   Rect     appPaper;

   short    devType;
   short    pageV;
   short    pageH;
   char     filler;
   char     feed;
   short       devKind;
   short       devVRes;
   short       devHRes;
   Rect        devPage;
   short       actualCopies;
   short       options;
   short       reduction;
   char        orientation;

   char        qualityMode;
   char        firstTray;
   char        remainingTray;
   char        coverPage;
   char        headMotion;
   char        saveFile;
   char        userCluster1;
   char        userCluster2; 
   char        userCluster3;
   short       firstPage;
   short       lastPage;
   short       copies;
   char        reserved1;
   char        reserved2;
   PrIdleProcPtr  pIdleProc;
   Ptr         pFileName;
   short       fileVol;
   char        fileVers;
   char        reserved3;
   short    printX[19];
};
typedef struct gxUniversalPrintRecord gxUniversalPrintRecord, 
*gxUniversalPrintRecordPtr, **gxUniversalPrintRecordHdl;
Field Description

prVersion
The version ID of this converted print record. This value is always the constant gxPrintRecordVersion, a value of 8.
appDev
The kind of device this print record applies to. At this time, this field always has the value 0.
appVRes
The vertical resolution of the application.
appHres
The horizontal resolution of the application.
appPage
The page size for this print record, stated in terms of the application resolution.
appPaper
The paper rectangle for this print record. This value is an offset from the value of the appPage field (the page always fits within the paper, and the edge of the paper is a negative offset from the page).
devType
The device type for this print record. At this time, the value of this field is always 0.
pageV
The vertical page height in 120ths of an inch.
pageH
The horizontal page width in 120ths of an inch.
filler
Unused.
feed
The feed mode used for this print record. The possible values are given in the section "Feed Mode Options for the Universal Print Structure" on page 4-15.
devKind
The kind of device for this print record. At this time, the value of this field is always 0xA900.
devVRes
The vertical resolution of the device.
devHRes
The horizontal resolution of the device.
devPage
The page size of the device.
actualCopies
The actual number of copies for this print job.
options
The options for this device. The constants that you can combine into a single value for this field are given in the "Print Options for the Universal Print Structure" on page 4-15.
reduction
The reduction or enlargement factor used for this print job.
orientation
The orientation of the paper. The possible values are given in the section "Paper Orientation Options for the Universal Print Structure" on page 4-16.
qualityMode
The quality mode used for this print job. The possible values are given in the section "Print Quality Modes for the Universal Print Structure" on page 4-17.
firstTray
Which of the printer's paper trays is used as the first paper tray for this print job. The possible values are given in the section "Paper Tray Selections for the Universal Print Structure" on page 4-17.
remainingTray
The other paper tray used for this print job. The possible values are given in the section "Paper Tray Selections for the Universal Print Structure" on page 4-17.
coverPage
The type of cover page to print for this print job. The possible values are given in the section "Cover Page Options for the Universal Print Structure" on page 4-18.
headMotion
The type of print-head motion to use for this print job. The possible values are given in the section "Print-Head Motions for the Universal Print Structure" on page 4-18.
saveFile
The type of file to save for this print job. The possible values are given in the section "File Save Types for the Universal Print Structure" on page 4-19. This field applies only to PostScript print jobs.
userCluster1
Unused.
userCluster2
Unused.
userCluster3
Unused.
firstPage
The number of the first page.
lastPage
The number of the last page.
copies
The number of copies. This value is always 1.
reserved1
Unused.
reserved2
Unused.
pIdleProc
A pointer to the idle procedure to use with this print job.
pFileName
A pointer to the name of the spool file for this print job.
fileVol
The volume reference number of the spool file volume.
fileVers
The spool file version, which must be 0.
reserved3
Reserved. This field must have a value of 0.
printX
Reserved for internal use.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help